home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / boot / czesc_2 / wiconify / wutilities.lzh / wIconifyScreen / wIconifyScreen.doc < prev    next >
Text File  |  1991-04-19  |  3KB  |  88 lines
  1. OVERVIEW:
  2.  
  3. wIconifyScreen is a companion program to wIconify.  It allows you to to
  4. request (from the CLI) that a screen be iconified, and also allows you to
  5. specify the icon's new position and some flags that control its functions
  6. within wIconify.  It is intended mainly for use within the Startup-Sequence
  7. and in EXECUTE scripts.
  8.  
  9.  
  10. HOW TO USE WICONIFYSCREEN:
  11.  
  12. To use wIconifyScreen, you must have wIconify running.  To iconify a screen,
  13. simply type
  14.  
  15.     1> wIconifyScreen [screen]
  16.  
  17. where [screen] is the name of the screen to iconify.  If the screen is not
  18. already iconified, and if it is able to be iconified, it will be replaced by
  19. an icon toward the bottom on the Workbench screen.  If the screen is already
  20. iconified, it will be restored and its icon removed.
  21.  
  22. If the screen name contains a space, enclose it in quotation marks, as in
  23. the example below:
  24.  
  25.     1> wIconifyScreen "Test Screen"
  26.  
  27. If you do not give a screen name, the currently active screen is assumed.
  28.  
  29. To specify the position of the icon, add 'AT x,y' to the commmand, where x
  30. and y are the position (in pixels) from the upper left-hand corner of the
  31. Workbench screen where you want the icon to appear.  wIconify will place the
  32. icon as close to this position as possible, without interfering with other
  33. icons.
  34.  
  35.     1> wIconifyScreen MicroEMACS AT 50,100
  36.  
  37. would iconify the EMACS screen and place the icon at 50 pixels from the
  38. left of the Workbench screen and 100 pixels down from the top of the screen.
  39. If you do not specify a position, the first available position will be used.
  40.  
  41. You must not put space around the comma when you specify a position.  Thus
  42. '10 ,20' '45, 110' and '55 , 75' are all illegal position, while '300,50' is
  43. acceptable.
  44.  
  45. You can also supply a number of flags that alter the way wIconify treats the 
  46. screen's icon.  These include:
  47.  
  48.     NOSAVEPOS       Don't save the icons possition after it is openned
  49.     NOMOVE          Don't allow the icon to be dragged from its current position
  50.     NOORGANIZE      ORGANIZE and CLEANUP will not affect this icon
  51.     LOCKED          Don't allow the icon's position to change at all
  52.     NOMULTISELECT   Don't allow other icons to be selected together with
  53.                     this one
  54.  
  55. You can plas a minus sign (-) in front of any of these flags; this will case
  56. the given attribute to be removed from the icon.  For example, -NOMOVE
  57. would remove the NOMOVE attribute, hence the icon would become moveable.
  58.  
  59. If you supply any of these flags, they will remain in effect until you close
  60. the screen, or until you issue another wIconifyScreen command for the given
  61. screen that changes the settings of the flags.  The default is to change none
  62. of these flags.
  63.  
  64.  
  65. TECHNICAL NOTES:
  66.  
  67. You may not iconify the Workbench screen itself, since this is where the
  68. screen icons appear.
  69.  
  70. When a screen is iconified, its memory is still in use, so it does not save
  71. any memory to iconify a screen.  It is simply a visual aid to help you
  72. organize your screens.
  73.  
  74. The way that screen iconification works is that wIconify simply moves the
  75. screen vertically so that it is off the bottom of the display area.  This is
  76. not prohibited by Intuition, but may not be completely acceptable, either. 
  77. If you experience problems with iconified screens, it may be best not to
  78. iconify them.
  79.  
  80.  
  81. AUTHOR:
  82.  
  83. Davide P. Cervone
  84. Mathematics Department
  85. Brown University
  86. Providence, Rhode Island 02912
  87. ST402523@BROWNVM
  88.